Windows に Eggplant DAI をインストールまたはアップグレードする
このセクションでは、Microsoft Windowsシステムにオンプレミス（「オンプレミス」）インストールとしてEggplant DAIをインストール、アップグレード、またはライセンス取得するための手順を段階的に説明します。インストールプロセスを開始する前に、前提条件を必ずお読みください。サポートされているオペレーティングシステムと推奨されるインストール構成に関する情報が記載されています。
以下は、Windows、Mac、Linux に EPF をインストールする手順です。
標準とアドバンスのインストール
Eggplant DAIは、Windowsでは標準インストールと詳細インストールのどちらかを選択できます。詳細インストールでは、以下の追加設定が可能です。
- デフォルトのポート設定を更新し、HTTPSを構成する
- PostgreSQLのデータが格納されるディレクトリを選択する
- Eggplant FunctionalのSuiteが保存されるディレクトリを選択する。
両方のインストールタイプに対して、インストールを開始するのステップに従い、適切なセクションにジャンプします。
サイレントインストール
DAI 7.4 以降では 、Windows 上で DAI サーバーのインストール、アップグレード、またはアンインストールを自動化したい場合、またはマシンへのコマンドライン アクセスのみを使用している場合でも、「サイレント」で実行できます。詳細については、サイレント インストール、アップグレード、またはアンインストール を参照してください。
Eggplant DAIのインストール
Eggplant DAI Windows インストールでは以下がサポートされます。
- 新規インストール
- 以前のサポート バージョンからの増分 アップグレード (サポートされるバージョンの完全なリストについては、リリース ノート を参照してください)。
- ダウングレードはサポートしていません。
アップグレードする場合は、インストールを開始する前に、必ずすべての DAI サーバーとサービスを停止し、ファイルとデータをバックアップしてください。ご質問がある場合、またはアップグレード前のデータベースのテストについてサポートが必要な場合は、テクニカル サクセス マネージャーまたは弊社の カスタマー サポート までお問い合わせください。
バックアップを取るには：
- Windows Services managerを通じてDigital Automation Intelligence Serviceを停止します。
C:\ProgramData\Eggplant\Digital Automation Intelligenceを開き、ProgramDataディレクトリの外にあるdataフォルダーとminioフォルダーを別のマシンまたはバックアップ デバイスにコピーします。- Digital Automation Intelligence サービスを起動します。
アップグレードで問題が発生し、以前に動作していた DAI バージョンを復元する必要がある場合は、次の手順に従います。
- トラブルシューティングに役立つ可能性があるDAIファイルとデータのバックアップを作成するため、上記の手順1と2を繰り返します。
- Windows の コントロール パネ の プログラムと機能 オプションを使用して DAI をアンインストールします。
- フォルダ
C:\ProgramData\Eggplantを削除します。 - フォルダ
C:\Program Files\Digital Automation Intelligenceが存在するかどうかを確認し、存在する場合は削除します。この時点で、DAIはマシンから完全に削除されています。 - 以前動作していたバージョンの DAI をインストールします。DAI の再インストールが完了したら、ブラウザを起動して DAI Web UI にログインし、インストールを確認します。
- Windows サービスから DAI サービスを停止します。
- フォルダ
C:\ProgramData\Eggplant\Digital Automation Intelligenceに移動し、dataフォルダとminioフォルダを削除します。 - DAIバックアップの場所から
dataフォルダとminioフォルダをC:\ProgramData\Eggplant\Digital Automation Intelligenceにコピーします。バックアップ ファイルは、手順 5 でインストールした DAI バージョンとまったく同じである必要があることに注意してください。 - バックアップの場所からファイル 'config.yml' を開き、データベースのパスワード
envセクションのPG_PASSWORDの値 をコピーします。C:\ProgramData\Eggplant\Digital Automation Intelligenceのファイルconfig.ymlを開き、PG_PASSWORDの値をバックアップしたパスワードに置き換えます。 - DAI サービスを開始し、開始後に DAI Web UI にログインできることを確認します。
インストールを開始する
新規インストールまたは前のマイナーDAIリリースからのアップグレードにこれらの指示を使用します。
-
インストールファイルを右クリックして、Run as Administratorオプションを使用してSetupウィザードを起動します。続行するにはNextをクリックします。
注意点DAIのインストーラーは可能な限り管理者として実行することをお勧めします。これにより、DAIは正しい権限でインストールされます。
まだアンインストールしていない場合は、Eggplant DAI をアンインストールするように求められる場合があります。
-
デフォルトのインストールディレクトリ
C:\Program Files\Digital Automation Intelligenceを保持するか、Browse.... をクリックして別の場所を選択します。 -
Advanced installer Options画面で、以下のどちらかを行います。
標準インストールの実行
前提条件: インストールを開始するのすべての手順を完了します。
-
Server & Administration Settings 画面で、次の内容を入力します。
-
DAI Server Hostname: URLの主要なDAIサーバーのホスト名。ホスト名に
http://やhttps://の接頭辞は含めないでください。- サーバーがローカルマシンである場合は、
localhostと入力します。これは、Eggplant DAIはhttp://localhost:8000からのみアクセスできることを意味します。 - DAIサーバーに他のリモートマシンからアクセスする必要がある場合は、完全なドメイン名（例：
www.serverhostname.com）を入力します。これにより、例えばhttp://<serverhostname>:8000からブラウザでEggplant DAIにアクセスできます。
ヒントサーバーのホスト名を調べるには、Settings > システム > このPCについてに移動します。
- サーバーがローカルマシンである場合は、
-
System管理者の詳細: Eggplantのアイデンティティアクセス管理システム(IAM)の管理者の資格情報。
- username:
< > \ / { } " % ! ^と大文字を除いたASCII印刷可能な文字のみを入力します。 - Password:
" \ { } % ! ^を除いたASCII文字を使用して、12から128文字の間で入力します。 :::info 重要
重要システム管理者アカウントの資格情報は安全な場所に保管してください。特定の状況下では、Eggplantテクニカルサクセスマネージャーから探して使用するように依頼される場合があります。
- username:
-
DAI管理者の詳細: DAI管理者の資格情報と個人詳細。
- username:
< > \ / { } " % ! ^と大文字を除いたASCII印刷可能な文字のみを入力します。 - Password:
" \ { } % ! ^を除いたASCII文字を使用して、12から128文字の間で入力します。
注意点Eggplant DAIへの初回ログイン、および他のユーザーの作成・更新には、DAI管理者の認証情報が必要です。ログイン後、パスワードを更新して、上記の除外文字に加え、他の言語や文字（例：Unicode）を含めることができます。管理者のユーザー名は更新できません。
DAI でシングル サインオン (SSO) 認証を使用する場合は、最初のログインとライセンスおよびシングル サインオン (SSO) 認証と DAI の統合で説明されているように、DAI バージョン 7.1 以上をインストールした後で設定します。
- username:
-
-
Select Start Menu Folder 画面に進むには、Nextをクリックします。
-
Eggplant DAIへのショートカットの別の場所を選択するには、デフォルトの設定を受け入れるか、Browse… をクリックします。
-
Ready to Install 画面に進むには、Nextをクリックしてください。インストールを開始するには、Installをクリックしてください。
-
インストールが完了すると、DAI Windows Service Start-up 画面が表示され、DAI サービスが初めて起動します。このプロセスには最大10分かかる場合があり、必要に応じて移行アクティビティも実行されることがあります。
-
デフォルトのインターネットブラウザでHTML形式のDAI Windowsサービス起動レポートが開き、正常に起動したサービスの一覧が表示されます。この起動レポートに示されているように、すべてのDAIサービスが正常に起動していれば、移行プロセスは正常に完了しています。起動中に発生したエラーはすべて、トラブルシューティングに役立つようここに詳細が記録されます。
-
セットアップが完了したら、Finishボタンをクリックします。
-
DAIサービスが正常に起動できない場合は、Windowsサービスマネージャを通じてDAIサービスを再起動するか、PCを再起動する必要があります。
高度なインストールの実行
Preconditions：
- インストールの開始のすべての手順を完了します。
- Eggplant DAIサーバでHTTPSを設定するには、信頼できる証明書とキーが必要です。信頼できる証明書は、Mozillaのページに記載されている認証局によって発行されます。
Windows環境では、証明書はブラウザまたはエージェントを実行しているマシンに信頼されたルート認証機関としてインストールされている別の証明機関によって署名できます。
自己署名SSL証明書を使用する場合は、インストール後に設定を更新する必要があります。以下の設定を行ってください。
- 発行者 は証明書を発行する組織です（例：
"yourcompanyname"）。 - サブジェクト_は証明書が生成されたホスト名、たとえば"local.dai.com"に設定し、インストール中に入力したホスト名と一致する_必要があります。
ChromeとFirefoxでエンドエンティティ証明書を受け入れるには、サブジェクト代替名と認証局鍵識別子のフィールドを設定する必要があります。暗号的に十分な強度を持つハッシュ関数を使用してください。現在、sha512が受け入れられます。
-
PostgresSQL データ ディレクトリ 画面で、次のいずれかを実行します。
- デフォルトのパスを受け入れるには、Nextをクリックします。
- 別のディレクトリを選択するには、Browseをクリックします。たとえば、DAIデータベースのカスタムロケーションを使用するには、
C:\MyCompany\Dataに移動します。
重要DAIはWindowsの
local systemアカウントの下で動作します。このアカウントが選択したディレクトリに書き込む権限を持っていることを確認する必要があります。そうでなければ、インストールが失敗します。Make New Folderをクリックすると、別のデ イレクトリを選択したときに適切な権限が設定されることが確認できます。 -
Server Port & HTTPS画面に進むには、Nextをクリックしま す。
-
このポートが利用できず、別のポートを使用する必要がある場合を除き、デフォルトのポート値「8000」のままにしておいてください。インストール後はいつでも設定を更新できます。
注意点ポート
80は、HTTPまたはHTTPSの設定のいずれにも現在サポートされていません。 -
DAI サーバーを保護するために HTTPS を構成しない場合は、Use HTTPS チェックボックスをオフにして、Next をクリックし、手順 6 に進みます。それ以外の場合は、Use HTTPS チェックボックスをオンのままにして、次の手順に進みます。
- ポート8000が利用可能な場合は、デフォルト値をそのままにします。
- ポート8000が利用できない場合は、使用するHTTPポートを入力します。
-
証明書の詳細を追加します：
- HTTPS証明書： HTTPS証明書をブラウズして選択します。
- HTTPS Private Key： HTTPSキーファイルをブラウズして選択します。
- （オプション）プライベートキーにはパスワードが必要： プライベートキーを解除するためにパスワードが必要な場合は、このオプションを選択し、パスワードファイルをブラウズして選択します。
-
NextをクリックしてUsage Statistics画面に進みます。次のメトリクスを収集するためにEggplantに許可を与えるためにチェックボックスを選択したままにします：
- 製品識別子
- 製品バージョン
- ホストOS
- ホストOSバージョン
- ライセンス（シリアル番号）情報。
-
NextをクリックしてSuites Data Directory画面に進みます。次のいずれかを選択します：
- デフォルトのパスを受け入れるには、再度Nextをクリックします。
- Browse をクリックして、Eggplant Functionalスイートの別のディレクトリを選択してください。これは、[DAI Design Agent]がスイートをアップロードするディレクトリであり、現在スイートを保存している場所とは異なる場合があります。
重要DAIはWindowsの
local systemアカウントの下で動作します。このアカウントが選択したディ レクトリに書き込む権限を持っていることを確認する必要があります。そうでなければ、インストールが失敗します。Make New Folderをクリックすると、別のディレクトリを選択したときに適切な権限が設定されることが確認できます。 -
標準インストール のすべての手順を完了します。
DAIはプロセス間通信にメッセージブローカー（RabbitMQ）を使用します。DAIでHTTPSを使用するように設定する場合、DAI設定ファイル（config.yml）の設定を変更することで、Rabbit MQ通信を暗号化できます。手順については、RabbitMQ通信の暗号化をご覧ください。
初回ログインとライセンス認証
Eggplant DAI がインストールされて実行さ れている場合、ブラウザからアプリケーションにアクセスする必要があります。次の手順に従って、ログインし、ライセンスを取得し、Eggplant DAI の使用を開始します。
-
ブラウザから適切なURLを入力してログイン画面を表示します：
- インストール中にホスト名
localhostを追加した場合は、Eggplant DAIサーバーが実行されているコンピューターからブラウザを起動し、http://localhost:8000を入力します。 - インストール中に完全なホスト名を追加した場合、リモートマシンからEggplant DAIサーバーにアクセスすることができます。ブラウザを起動し、
http://<serverhostname>:8000を入力します。
- インストール中にホスト名
-
Eggplant DAIがログインを求めます。インストール中に設定したDAI管理者アカウントのユーザー名とパスワードを入力し、OKをクリックします。
-
「ライセンス」ページでLicense Key を入力し、Agreeをクリックします。 Agree をクリックする前に、Eggplantソフトウェアライセンス契約書のコピーを読んだりダウンロードしたりできます。ライセンスはKeysight Software Manager (KSM)で生成できます。ライセンスに同意すると、**設定**ページが表示され、メールを設定できます。メールが設定されると、新しいDAIユーザーは独自のパスワードを設定できます。この手順はスキップできますが、ユーザーに一時パスワードを提供する必要があります。
-
ユーザーアカウントの更新を行うことができます。Eggplant DAIインターフ ェースの左メニューでAccessをクリックします。
DAI で Microsoft Active Directory (AD) によるシングル サインオン (SSO) 認証を使用する場合は、DAI とのシングル サインオン (SSO) 認証の統合 を参照してください。